加油下单&支付 | 百度->商户
更新时间:2023-02-07
下单并获取支付参数
接口描述
本接口主要用户创建订单成功后获取支付参数
权限说明
注意事项
- 超时时间:要求接口耗时小于1.5S(超过1.5S触发超时重试),重试策略:超时默认重试3次。
- 返回值判断:
a.返回数据格式:json,包含字段如:{"errno":0,"msg":"success","data":{}}
请求参数
参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
---|---|---|---|---|
station_id | String | 是 | RequestBody参数 | 油站ID,商户提供 |
gun_no | String | 是 | RequestBody参数 | 油枪号 |
oil_no | String | 是 | RequestBody参数 | 油号 示例:92 |
total_amount | String | 是 | RequestBody参数 | 订单总金额 |
pay_amount | String | 是 | RequestBody参数 | 支付金额 |
promotion_amount | String | 是 | RequestBody参数 | 百度优惠金额 |
openid | string | 是 | RequestBody参数 | 用户唯一标识 |
bd_pre_order_id | String | 是 | RequestBody参数 | 百度唯一单号 |
bd_pay_order_id | String | 是 | RequestBody参数 | 百度支付单号 |
pay_type | String | 是 | RequestBody参数 | 支付方式 1:支付宝,2:微信 |
trade_type | String | 是 | RequestBody参数 | 交易类型 H5:H5支付,APP:移动端 |
coupon_id | String | 是 | RequestBody参数 | 优惠券ID |
return_url | String | 是 | RequestBody参数 | 支付成功后的跳转地址,需要商户透传给支付宝/微信 |
响应参数
参数名称 | 父节点 | 类型 | 是否必传 | 描述 |
---|---|---|---|---|
errno | 无 | int | 是 | 错误码,0:成功 |
msg | 无 | string | 是 | 结果描述,success:成功 |
data | 无 | json | 是 | 预定结果 |
bdOrderId | data | string | 是 | 百度支付订单号 |
tpOrderId | data | string | 是 | 商户订单号 |
payString | data | string | 是 | 支付参数 |
请求示例
{
"tp_name":"test",
"salt":681161,
"timestamp":1648642558,
"sign":"ca852a6df07aa4653d1d0848bd893247",
"bd_orderid":"xxx"
"station_id":"xx",
"gun_no":"xx",
"oil_no":"xx",
"total_amount":"xx",
"pay_amount":"xx",
"promotion_amount":"xx",
"pay_type":"1"
"trade_type":"H5"
}
响应示例
{
"errno": 0,
"msg": "ok",
"data": {
"bdOrderId":"xxx",
"tpOrderId":"xxx",
"payString":"xxx",
}
}
支付宝返回示例:【高版本】 支付宝官方文档:https://opendocs.alipay.com/open/204/105465/
{
"data": {
"bdOrderId": "zn_1b9021b4509b1816",
"payString": "alipay_sdk=alipay-sdk-java-3.4.49.ALL&app_id=2021003129698420&biz_content=%7B%22body%22%3A%22%E5%B9%BF%E4%B8%9C%E7%9F%B3%E5%8C%96%E9%A1%BA%E9%A3%8E%E5%8A%A0%E6%B2%B9%E7%AB%99-95%22%2C%22out_trade_no%22%3A%2201oLmsaG20230207175210%22%2C%22subject%22%3A%22%E5%B9%BF%E4%B8%9C%E7%9F%B3%E5%8C%96%E9%A1%BA%E9%A3%8E%E5%8A%A0%E6%B2%B9%E7%AB%99-95%22%2C%22timeout_express%22%3A%2230m%22%2C%22total_amount%22%3A%22187.45%22%7D&charset=UTF-8&format=json&method=alipay.trade.app.pay¬ify_url=https%3A%2F%2Fapi.aicwx.com%2Fpayment%2Fnotify%2Falipay%2F01oLmsaG20230207175210%2Faliapppay%2F01%2FrefuelWeChat&sign=ieCXAY1CPv%2B7SFljyj8E1F1V8l2b0lackD%2BiswPVVKnaOw0APgaazEqAcGYAYcoD%2F9kWkqVMc4%2Br1z3M1zBfPKWO4FR0L%2B0YdtDLQ381J0sNslZOriu19uDDw%2Blqn0QlCHGRU8zkD48HIuiIPBx5lB%2F%2BS82ogQBk6%2Fno6ODvKoV5V3ZuYa6GCyUOBLHXigfeHhtXLXlgcGY4fThigX9tcIt4r2oBhHpC7xtSaisrukLMLLTyPEWW%2BdIDNy7M95E%2F7Bl7TV1IwfzTe9a6%2BgxSQb%2BX6fJnYE%2B8hcBOma4BPhqS%2FIcdTTNFRQjSsC1RxG9%2B7n62%2BsytQFqawIKMEd018Q%3D%3D&sign_type=RSA2×tamp=2023-02-07+17%3A52%3A10&version=1.0",
"tpOrderId": "tVbagQ20230207175210"
},
"errno": 0,
"msg": "success"
}
支付宝返回示例:【地图低版本15.5左右】
{
"data": {
"bdOrderId": "zn_6d96e181e6f97900",
"payString": "<form name=\"punchout_form\" method=\"post\" action=\"https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.wap.pay&sign=NSrrp7CWH3X0Vk0uro%2BpAkRAJ%2FgdIfTXq1qK1vwy24YRCpCrz2Ba0qIoJrvaFWmRMO8q9wDFBs99swduF2uiWb%2Bi65vDSn7y5HFq0YUwT7NCq9RcijXB3SGYFC%2BX9LHT0N7Oeqgf9HNJlIGkwj%2BoD9DebTEZKhEBjZo9VOYIfub%2FnI6J0oNhebAWZXa3gSMPrnG%2B4jlZWzHguyjzpktNdOj6sWbeViWmUhHWeiJNJ33fY3RfwIPvnzkNPLpLf4%2BqRQkrpzWryLvALd68f9xGnNMMLLj7S%2FAf6nzurxfVhsBnLrgIyFXpfC2o8si35yrgxMKyy%2Banc5BImRQYIHGEgw%3D%3D&return_url=https%3A%2F%2Fmsdev.czb365.com%2Fpay¬ify_url=https%3A%2F%2Ftest01-paycallback.czb365.com%2Fservices%2Fcallback%2FaliPay%2Fversion11&version=1.0&app_id=2019091967553889&sign_type=RSA2×tamp=2022-11-09+18%3A59%3A32&alipay_sdk=alipay-sdk-java-3.7.110.ALL&format=json\">\n<input type=\"hidden\" name=\"biz_content\" value=\"{ "out_trade_no":"CZBA157188965387501", "quit_url":"", "total_amount":"96.70", "subject":"团油平台合作商户订单-01", "product_code":"QUICK_WAP_PAY" }\">\n<input type=\"submit\" value=\"立即支付\" style=\"display:none\" >\n</form>\n<script>document.forms[0].submit();</script>",
"tpOrderId": "nKEtis20230207124807"
},
"errno": 0,
"msg": "success"
}
微信返回示例:【payString接入方按照此格式返回,实现方式:地图server透传到地图端,通过地图的端能力调起微信客户端支付】
微信低版本:暂不考虑,地图针对低版本隐藏处理
payString释义详见微信官方文档:https://pay.weixin.qq.com/wiki/doc/api/H5.php?chapter=9_20
{
"data": {
"bdOrderId": "zn_6d96e181e6f97900",
"payString": "{\"package\":\"Sign=WXPay\",\"appid\":\"wx9a08a4f59ce91bf6\",\"sign\":\"41642AB0C2B9C5B8C93783479326D528\",\"partnerid\":\"1621762132\",\"prepayid\":\"wx071248072578791becbd7167821fd00000\",\"noncestr\":\"1675745287320\",\"timestamp\":\"1675745287\"}",
"tpOrderId": "nKEtis20230207124807"
},
"errno": 0,
"msg": "success"
}